home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / progs / editor / frexxed / fpl / completeword.fpl.readme < prev    next >
Text File  |  1996-01-17  |  3KB  |  87 lines
  1. #############################################################################
  2. File:        CompleteWord.FPL
  3. Author:        Jesper Skov
  4. Email:        jskov@iesd.auc.dk
  5. Short:        Complete current word with matching words in document 
  6. Version:    1.3
  7. Date:        17.01.96
  8. Local settings:
  9. Global settings:
  10. Keysequence:    Amiga /
  11. Type:        function
  12. Prereq:
  13. Copyright:    © 1995-1996, Jesper Skov
  14. #############################################################################
  15.  
  16. FUNCTION
  17.  
  18.   This function completes the word at the cursor with matching words found in
  19.   the document. First the upper half of the document is searched then the
  20.   lower half. If you activate the function repeatedly, different completions
  21.   will be inserted. Completions you do not accept will only be showed once!
  22.  
  23.   Example text:
  24.  
  25.     fool  fuck_off  fuck off  FOOD  foobar  food for thought  f   friends
  26.                                                                ^   *
  27.  
  28.   Activating the function at the ^ mark will result in the following
  29.   strings replacing the letter f:
  30.  
  31.    Activation#        String
  32.    ---------------------------------------
  33.          0           f (obviously :)
  34.          1           for
  35.          2           food
  36.          3           foobar
  37.          4           fuck
  38.          4*          fuck_off
  39.          5           fool
  40.          6           friends
  41.          7           f (cycle restarts)
  42.  
  43.   Note that the FACT has a bit to say about how words are recognized. Here 4*
  44.   will only appear if the '_' char is a word symbol. If not, the first part
  45.   of the word (fuck) would be recognized, but also canned since you had
  46.   already discarded "fuck" in step 4.
  47.  
  48.   The same word expansions would result if the cursor was placed at the *
  49.   (i.e. between 'f' and 'r').
  50.  
  51.   You would probably want the '_' char to be a word symbol if you use
  52.   underscore in your labels or function declarations...
  53.  
  54.   If you can get used to this little helper (it is quite easy!) you will be
  55.   able to speed up your writing! Especially if programming where
  56.   labels/constants are excellent food for this beast.
  57.  
  58.  
  59. HISTORY (REV)
  60.   17.01.96 (3)    Does not replace with same word now.
  61.         Display is turned off while reading the search string.
  62.   18.05.95 (2)    Just a *minor* change from GetBufferID() to GetEntryID()!
  63.         By Daniel Stenberg. Made it work better with split views...
  64.   02.03.95 (1)    Now works case in-sensitive.
  65.   03.02.95 (0)    Works a lot faster than I had ever hoped. Smoooking!
  66.  
  67.  
  68. BUGS
  69.   As of revision 3, the display is turned off while the search string is
  70.   read. This causes an update overhead *if* the word is replaced with another
  71.   word. If you think it works too slow now, please let me know (coz' it seems
  72.   fast enough on my cyberThing(TM))
  73.  
  74. TODO
  75.   A flag that defines if the found word should be capitalized like the
  76.   word you try to complete.
  77.  
  78.   Search through all buffers for a match. This feature is in the Emacs 19.28,
  79.   but it works so incredible fast that I'm not sure they just use normal
  80.   searching. Or maybe the Suns are just way faster than the Amiga :) We'll
  81.   see when the FPL compiler gets around.
  82.  
  83. SEE ALSO
  84.   Documentation on FACTs.
  85.  
  86.   Stephen King's "Four Past Midnight" (ISBN: 0-340-53526-1)
  87.